package com.zym.init.service;

import com.baomidou.mybatisplus.extension.service.IService;
import com.zym.init.model.dto.PageDTO;
import com.zym.init.model.po.UserPo;
import com.zym.init.model.query.UserQuery;
import com.zym.init.model.vo.UserVo;

/**
 * @author zouyangming
 * @description 针对表【user(用户表)】的数据库操作Service
 * @createDate 2023-10-15 16:46:17
 */
public interface UserService extends IService<UserPo> {

    /**
     * 获取用户列表
     *
     * @param query 查询条件
     * @return 用户列表
     */
    PageDTO<UserVo> getPage(UserQuery query);

    /**
     * 新增用户
     *
     * @param query 用户注册信息
     * @return 注册结果
     */
    boolean add(UserQuery query);

    /**
     * 根据用户名查询用户
     *
     * @param username 用户名
     * @return 用户对象
     */
    UserPo selectUserByUsername(String username);

    /**
     * 获取用户是否已被封禁状态
     *
     * @param userId 用户id
     * @return true：已被封禁；false：未被封禁
     */
    void checkUserIsBanned(Long userId);

    /**
     * 校验用户是否允许操作
     *
     * @param userPo 用户对象
     */
    void checkUserIsAllowed(UserPo userPo);

    /**
     * 校验用户名称是否唯一
     *
     * @param username 用户名
     */
    void checkUsernameIsUnique(String username);
}
